如何使用多种节点使用游戏特效系统本页总览使用游戏特效系统 1. 引言 在游戏开发中,特效是提升游戏视觉体验的重要元素。它们可以增强游戏的氛围、突出关键事件,并提供即时的视觉反馈。本教程将介绍如何在 Dora SSR 引擎中使用 Effekseer 特效系统,以及如何使用引擎自带的 Particle 粒子系统。 制作 .par 粒子的操作步骤与截图见粒子编辑器。 2. 什么是 Effekseer? Effekseer 是一个免费、开源的特效编辑器,支持 Windows、macOS 和 Linux 等多个平台。它允许美术人员和开发者创建各种粒子效果,如爆炸、火焰、光束等。Effekseer 支持多种渲染模式和高级特性,如: 粒子发射与控制:支持从点、线、面等多种形状发射粒子,并可对粒子的生命周期进行精细控制。 渲染特性:支持混合模式、纹理贴图、光照和阴影等。 多平台支持:可导出特效到多种游戏引擎和平台,包括 Dora SSR 等。 3. 使用 Effekseer Dora SSR 引擎已经集成了 Effekseer 特效系统,开发者可以直接在游戏中加载和播放 Effekseer 编辑器生成的特效文件(通常以 .efk 或 .efkefc 为扩展名)。 3.1 EffekNode 类的使用 在 Dora SSR 中,可以使用 EffekNode 类来管理 Effekseer 特效的播放,并作为一个场景节点管理特效的几何位置、旋转和缩放等属性。以下是 EffekNode 类的主要方法和用法: 创建 EffekNode 对象 LuaTealTypeScriptYueScriptlocal EffekNode <const> = require("EffekNode")local effekNode = EffekNode()local EffekNode <const> = require("EffekNode")local effekNode = EffekNode()import { EffekNode } from "Dora";const effekNode = EffekNode();_ENV = DoraeffekNode = EffekNode! 播放特效 LuaTealTypeScriptYueScriptlocal handle = effekNode:play("Particle/effek/Laser01.efk", Vec2(100, 200), 0)local handle = effekNode:play("Particle/effek/Laser01.efk", Vec2(100, 200), 0)const handle = effekNode.play("Particle/effek/Laser01.efk", Vec2(100, 200), 0);handle = effekNode\play "Particle/effek/Laser01.efk", Vec2(100, 200), 0 play 方法接收的参数如下: filename:特效文件的路径。 pos(可选):播放特效的二维坐标,默认为 (0, 0)。 z(可选):播放特效的 Z 轴坐标,默认为 0。 停止特效 LuaTealTypeScriptYueScripteffekNode:stop(handle)effekNode:stop(handle)effekNode.stop(handle);effekNode\stop handle handle:play 方法返回的特效句柄。 监听特效结束事件 LuaTealTypeScriptYueScripteffekNode:onEffekEnd(function(handle) print("特效已结束,句柄:" .. handle)end)effekNode:onEffekEnd(handle => { print("特效已结束,句柄:" .. handle)})effekNode.onEffekEnd(handle => { print("特效已结束,句柄:" + handle);});effekNode\onEffekEnd (handle) -> print "特效已结束,句柄:#{handle}" 3.2 实战示例:播放一个激光特效 以下是一个完整的示例,展示如何在 Dora SSR 中播放一个名为 Laser01.efk 的激光特效,并在特效结束时进行回调处理。 LuaTealTypeScriptYueScript-- 引入必要的模块local EffekNode <const> = require("EffekNode")local Vec2 <const> = require("Vec2")-- 创建 EffekNode 对象local effekNode = EffekNode()-- 设置特效节点整体的 3D 旋转角度effekNode.angleY = -90-- 在坐标 (100, 200) 处播放激光特效local laserHandle = effekNode:play("Particle/effek/Laser01.efk", Vec2(100, 200))-- 注册特效结束回调effekNode:onEffekEnd(function(handle) if handle == laserHandle then print("激光特效已结束") endend)-- 引入必要的模块local EffekNode <const> = require("EffekNode")local Vec2 <const> = require("Vec2")-- 创建 EffekNode 对象local effekNode = EffekNode()-- 设置特效节点整体的 3D 旋转角度effekNode.angleY = -90-- 在坐标 (100, 200) 处播放激光特效local laserHandle = effekNode:play("Particle/effek/Laser01.efk", Vec2(100, 200))-- 注册特效结束回调effekNode:onEffekEnd(function(handle: integer) if handle == laserHandle then print("激光特效已结束") endend)// 引入必要的模块import { EffekNode } from "Dora";// 创建 EffekNode 对象const effekNode = EffekNode();// 设置特效节点整体的 3D 旋转角度effekNode.angleY = -90;// 在坐标 (100, 200) 处播放激光特效const laserHandle = effekNode.play("Particle/effek/Laser01.efk", Vec2(100, 200));// 注册特效结束回调effekNode.onEffekEnd(handle => { if (handle === laserHandle) { print("激光特效已结束"); }});-- 引入必要的模块_ENV = Dora-- 创建 EffekNode 对象effekNode = EffekNode!-- 设置特效节点整体的 3D 旋转角度effekNode.angleY = -90-- 在坐标 (100, 200) 处播放激光特效laserHandle = effekNode\play "Particle/effek/Laser01.efk", Vec2(100, 200)-- 注册特效结束回调effekNode\onEffekEnd (handle) -> if handle == laserHandle print "激光特效已结束" 3.3 控制特效的播放与停止 有时候,我们需要根据游戏逻辑来控制特效的播放和停止。例如,在玩家释放技能时播放特效,技能被打断时停止特效。 LuaTealTypeScriptYueScript-- 假设技能被打断,需要停止特效effekNode:stop(laserHandle)-- 假设技能被打断,需要停止特效effekNode:stop(laserHandle)// 假设技能被打断,需要停止特效effekNode.stop(laserHandle);-- 假设技能被打断,需要停止特效effekNode\stop laserHandle 3.4 多个特效的管理 如果需要同时播放多个特效,可以分别保存每个特效的句柄,并在回调中进行区分。 LuaTealTypeScriptYueScript-- 播放多个特效local handle1 = effekNode:play("Explosion.efk", Vec2(150, 250))local handle2 = effekNode:play("Sparkle.efk", Vec2(200, 300))-- 回调处理effekNode:onEffekEnd(function(handle) if handle == handle1 then print("爆炸特效已结束") elseif handle == handle2 then print("闪光特效已结束") endend)-- 播放多个特效local handle1 = effekNode:play("Explosion.efk", Vec2(150, 250))local handle2 = effekNode:play("Sparkle.efk", Vec2(200, 300)-- 回调处理effekNode:onEffekEnd(function(handle: integer) if handle == handle1 then print("爆炸特效已结束") elseif handle == handle2 then print("闪光特效已结束") endend)// 播放多个特效const handle1 = effekNode.play("Explosion.efk", Vec2(150, 250));const handle2 = effekNode.play("Sparkle.efk", Vec2(200, 300));// 回调处理effekNode.onEffekEnd(handle => { if (handle === handle1) { print("爆炸特效已结束"); } else if (handle === handle2) { print("闪光特效已结束"); }});-- 播放多个特效handle1 = effekNode\play "Explosion.efk", Vec2 150, 250handle2 = effekNode\play "Sparkle.efk", Vec2 200, 300-- 回调处理effekNode\onEffekEnd (handle) -> if handle == handle1 print "爆炸特效已结束" elseif handle == handle2 print "闪光特效已结束" 4. 使用 Particle 类 在 Effekseer 集成之前,Dora SSR 提供了 Particle 类来处理 2D 粒子特效。 注意然而,Particle 系统功能较为有限,主要依赖 CPU 进行计算,性能和效果都不如 Effekseer。因此,除非是只希望创建比较简单的粒子特效的场景,否则不推荐使用 Particle 类。 4.1 Particle 类的使用 创建 Particle 对象 LuaTealTypeScriptYueScriptlocal Particle <const> = require("Particle")local particle = Particle("effect.par")local Particle <const> = require("Particle")local particle = Particle("effect.par")import { Particle } from "Dora";const particle = Particle("effect.par");_ENV = Doraparticle = Particle "effect.par" Particle 构造函数接收一个参数: filename:粒子系统定义文件的路径。 开始和停止粒子发射 LuaTealTypeScriptYueScriptparticle:start() -- 开始发射粒子particle:stop() -- 停止发射粒子particle:start() -- 开始发射粒子particle:stop() -- 停止发射粒子particle.start(); // 开始发射粒子particle.stop(); // 停止发射粒子particle\start! -- 开始发射粒子particle\stop! -- 停止发射粒子 监听粒子系统结束事件 LuaTealTypeScriptYueScriptparticle:onFinished(function() print("粒子系统已结束")end)particle:onFinished(() => { print("粒子系统已结束")})particle.onFinished(() => { print("粒子系统已结束");});particle\onFinished () -> print "粒子系统已结束" 4.2 使用示例 LuaTealTypeScriptYueScript-- 引入 Particle 类local Particle <const> = require("Particle")-- 创建粒子系统对象local particle = Particle("effect.par")-- 注册粒子系统结束回调particle:onFinished(function() print("粒子系统已结束")end)-- 启动粒子发射particle:start()-- 引入 Particle 类local Particle <const> = require("Particle")-- 创建粒子系统对象local particle = Particle("effect.par")-- 注册粒子系统结束回调particle:onFinished(function() print("粒子系统已结束")end)-- 启动粒子发射particle:start()// 引入 Particle 类import { Particle } from "Dora";// 创建粒子系统对象const particle = Particle("effect.par");// 注册粒子系统结束回调particle.onFinished(() => { print("粒子系统已结束");});// 启动粒子发射particle.start();-- 引入 Particle 类_ENV = Dora-- 创建粒子系统对象particle = Particle "effect.par"-- 注册粒子系统结束回调particle\onFinished () -> print "粒子系统已结束"-- 启动粒子发射particle\start! 4.3 在 Web IDE 中编辑粒子 下载资源编辑器示例,上传并解压到工作空间,打开 ResourceLab/fire.par。示例保存的是“魔法”预设。自行创建时,右键点击项目文件夹,选择新建 → Dora 粒子。 点击 .par 文件,进入粒子编辑器。 在右侧选择火焰或魔法等预设作为起点。应用预设会修改粒子参数,保存后才会保留这些修改。 在通用区域调整发射率、最大数量、生命周期和生命周期变化。例如,把发射率改为 90,比较预览中粒子的疏密。 用暂停 / 播放观察运动,用重新播放从头预览。这些按钮控制编辑器内的预览。 在右侧面板内向下滚动,可以找到更多参数: 颜色与尺寸 / 旋转调整粒子生命周期中的颜色、淡出、大小和旋转。 纹理指定图片,点击 … 浏览资源;留空时使用默认粒子纹理。使用自定义图片时,将它与项目一起保留。 发射器 → 重力 / 半径选择运动模型,再调整速度、加速度或半径等参数,观察预览变化。 按 Ctrl+S(macOS 为 ⌘+S)保存,等待标签页名称前的星号消失,再重新打开文件确认参数。.par 是 XML 资源,需要检查保存的数据时,可以使用作为文本打开。 运行所属项目,在引擎中核对效果。示例 ResourceLab/init.lua 使用以下代码: local Dora = require("Dora")local particle = Dora.Particle("fire.par")particle.scaleX = 3particle.scaleY = 3particle:addTo(Dora.Director.entry)particle:start() 入口脚本将这个特效放大 3 倍,方便观察运行效果。 修改资源后,先保存再重新运行项目。.par 由项目脚本加载,不能使用“运行文件”单独执行。 5. 总结 用 EffekNode 加载 Effekseer 制作的特效,用 Particle 加载 .par 粒子资源。制作 .par 时,可以直接使用 Web IDE 的粒子编辑器,保存后再放入游戏场景验证。